DLLの実行とデバッグ

実行準備

  • エクステンションの配置先フォルダの直下に、エクテンションごとのサブフォルダを作成します(以降、格納フォルダと記します)。

    エクステンションの配置先フォルダの詳細については、開発ガイド > エクステンションの配布 > エクステンションの配置先 を参照してください。

  • Visual Studio のプロジェクトをビルドします。

  • ビルド結果の出力先フォルダとソースコードのフォルダから、次のファイル一式を格納フォルダにコピーして配置します。

{NextDesignAppFolder}\extensions\helloworld\
    manifest.json   ・・・ マニフェスト
    helloworld.dll ・・・ エントリーポイントに指定した DLL ファイル
    helloworld.pdb ・・・ デバッグ実行用情報ファイル
    locale.en.json  ・・・ 英語用ロケールファイル(多言語対応の場合)
    locale.ja.json  ・・・ 日本語用ロケールファイル(多言語対応の場合)
    resources\
        image.png   ・・・ マニフェストの拡張ポイントで指定したUIボタンのイメージファイル

注意

  • ビルド結果の出力先フォルダに次の DLL が出力されていても、これらのファイルはコピーしないでください。 Next Design のインストールフォルダに存在する同名のDLLと競合するため、正しく動作しなくなります。

    コピー対象外: NextDesign.Core.dll, NextDesign.Desktop.dll

デバッグ

  • プロジェクトのプロパティで、[デバッグ] > [開始動作] > [外部プログラムの開始] に Next Design インストールフォルダに存在する NextDesign.exe を指定します。

  • Visual Studio で [デバッグ] > [デバッグの開始] を実行します。

  • Next Design が起動すると、所定のフォルダに配置されたすべてのエクステンションのマニフェストが読み込まれ、エクステンションのライフサイクルに従って、拡張ポイントに定義したリボンタブやボタンが追加されます。

  • エクステンションのライフサイクルに従ってエクステンションが有効になると、Visual Studio 上で設定したブレークポイントも有効になります。

注意

  • Next Design 実行中にエクステンションを差し替えても、それらの変更は反映されません。
    • すべてのエクステンションは、Next Design を起動したタイミングで読み込まれて、Next Design 実行中は再読み込みされません。

重要

  • マニフェストの定義に誤りがあると、エクステンションが動作しません。
    • マニフェストの定義に誤りがあると、そのマニフェストは無視され、拡張ポイントとして定義したリボン要素も表示されません。
    • 稀に、マニフェストの誤りが原因で Next Design が起動しなくなる場合があります。そのような場合は、一時的にマニフェストのファイル名を manifest.json 以外に変更してから Next Design を再度起動させて確認してください。